home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / bpq351.arc / SWITCH.DOC < prev    next >
Text File  |  1989-10-14  |  7KB  |  181 lines
  1.     The G8BPQ AX25 Networking Package.
  2.  
  3.  
  4. 1. Introduction.
  5.  
  6. This software allows an IBM PC, or similar machine, equiped with suitable
  7. Communications hardware, to act as a Node in a NET/ROM compatible AX25 
  8. network, and/or to support a multiuser Mailbox, or other similar applications.
  9.  
  10. It supports multiple AX25 links, limited only by the connectivity of the 
  11. hardware and available storage. The interface to other software in the PC
  12. (Mailbox, application, or other terminal programs) is equivalent to a number
  13. (max 16, but possibly limited by memory requrements) of TNC's, accessed via
  14. the COMBIOS interface. One virtual TNC may be configured to run in a mode
  15. similar to the PK88 Host mode (for use with the UFQ BBS), others provide an
  16. interface similar to the TNC2.
  17.  
  18.  
  19. Note the software is NOT Public Domain. It may be used only by licenced
  20. Radio Amateurs in Amateur Packet Radio systems.
  21.  
  22.  
  23.  
  24. 2 Hardware Requirements.
  25.  
  26. The system is written in 8086 assembler, and is currently only available for
  27. the MSDOS/PCDOS environment, although once loaded it makes no use of operating
  28. system facilities. It has been tested on IBM PC and XT machines, and a number
  29. of similar machines. (AST Premium, Toshiba T1100+, OPUS). The software needs
  30. about 48 - 80k RAM, varying with number of buffers, comms links and COMBIOS
  31. ports configured.
  32.  
  33. Drivers are available for the following comms hardware:
  34.  
  35.     PAC-COM  PC120 card
  36.     DRSI PCPA card
  37.     Software Forge HDLC card for the Toshiba T1100 (with external modem).
  38.     KISS mode TNC via a standard PC ASYNC card.
  39.     Link to NET/ROM or TheNet Async port
  40.  
  41. The system has been tested up to 38400 bps on a DRSI card
  42.  
  43.  
  44. The software should my modifyable to run on any system with the following:
  45.  
  46.     8086/88/186/286 Processor
  47.     64k RAM
  48.     32k ROM or Bootstrap ROM plus disk
  49.     Timer interrupt with resolution of at most 50ms (better 10ms)
  50.     Interrupt driven SCC comms port(s) with suitable modems
  51.  
  52.  
  53. 3. Networking Facilities.
  54.  
  55. The system is designed to be operationally compatible with existing NET/ROM
  56. or TheNet nodes, but there are a few minor differences. As it can support
  57. an integrated BBS, it has 2 Callsign/Alias pairs, one for accessing the node,
  58. and the other the BBS. Note, however, that a multiport node does not need a
  59. different callsign for each port. Because of the multiport support, the 
  60. 'Downlink' connect command needs a port number as the first parameter (eg
  61. C 2 G8BPQ). A connect to another Node doesnt need this - the system selects
  62. the 'best' port as found from the NODEs and ROUTEs lists.
  63.  
  64. Although multiple applications are allowed, only one (BBS) has its own
  65. Callsign/Alias pair. Others are accessed by connecting to the switch, then
  66. entering the service name.
  67.  
  68. There are  extra commands for normal use (BBS, or other application name, to
  69. connect to the applications, and PORTS to display available port descriptions),
  70. and 2 commands intended primarily for the system operator (STATS and LINKS).
  71.  
  72. Two extra commands PACLEN and L4T1 are available to set Paclen for NODE
  73. generated messages (nodes lists, etc), and the Transport timeout. At the
  74. moment these are primarily for me to experiment with, but feel free to fiddle.
  75.  
  76.  
  77. The system is also able to link to the 'back end' async port on a normal
  78. NET/ROM or TheNet node.
  79.  
  80.  
  81. 4. Mailbox/Application Support Facilities.
  82.  
  83.  
  84. The system may be configured to run multiple copies of WA7MBL/W0RLI/G4YFB
  85. BBS software, (or others designed to talk to a standard TNC using the COMBIOS
  86. interface) running under DesqView, or one copy of G8UFQ BBS, supporting up
  87. to 15 users via a single virtual 'Host Mode' TNC. The Mailbox callsign and 
  88. alias are included in 'NODES' broadcasts, allowing level 4 connects direct to 
  89. the BBS (ie it is not necessary to connect to the node, then issue a connect to
  90. the BBS).
  91.  
  92.  
  93. Applications other than BBS must use the COMBIOS interface. (ie not Host Mode).
  94.  
  95.  
  96. 5. TNC Emulation Facilities.
  97.  
  98.  
  99. The Host Mode TNC emulation provides the minimum support necessary for use
  100. with the UFQ BBS.
  101.  
  102. The TNC2 emulation code accepts the following commands:
  103.  
  104.  
  105. CONOK ON/OFF    - Indicates the port is available for use. By default, it
  106.           will be for the BBS application. See APPL comand.
  107.  
  108.  
  109. APPL        - Bit significant field, to indicate which application the
  110.           port is supporting. The first three are reserved for BBS,
  111.           connects to the SYSOP (HOST support), and remote SYSOP
  112.           facilities. The other 5 are available for you to define your
  113.           own application servers (eg DATABASE, UNIX gateway).
  114.           Default is 01, the BBS.
  115.  
  116.           To allow users to connect to you (using the C command 
  117.           from the switch without a param), set APPL=02, and CONOK ON
  118.  
  119.  
  120. BBSMON ON/OFF    - Reduces the monitor output to calls only (enough to maintain
  121.           the JA list). Place in the MBL config file startup section.
  122.  
  123. MTX ON/OFF    - Monitors transmitted frames - mainly used for debugging
  124.  
  125. MONITOR ON/OFF    - As in normal TNC
  126. MALL ON/OFF
  127. MCOM ON/OFF
  128. MCON ON/OFF       Note that to monitor whilst connected to the Node, you 
  129.           need MCON ON 
  130.  
  131. MMASK         - Selects which (radio) ports will be monitored. A bit
  132.           significant field - setting bit 0 allows monitoring of 
  133.           the first port, bit 1 the second, and so on. Default is
  134.           hex FF, monitoring all radio ports. Setting it to zero
  135.           will suppress all monitoring.
  136.  
  137. The monitor code will decode and display the network headers from messages
  138. between nodes. This enables you to see what routes are being used between
  139. nodes, as well as removing a lot of garbage from the monitor display!
  140.  
  141.  
  142. NOMODE ON/OFF    The next 2 are accepted, but are not fully implemented. In 
  143. NEWMODE ON/OFF  general BBS connects assume NOMODE on, others NOMODE off.
  144.  
  145. CONNECT
  146.  
  147. To connect to the node, use the command NODE (or K). This is equivalent to
  148. connecting to a normal node. There is a (roughly) equivalent command
  149. C SWITCH, which returns the string *** CONNECTED to SWITCH, and is used
  150. in MBL forward files, as the MBL software is expecting the first connect
  151. to be at Level 2. A Connect command without a parameter returns the
  152. current state, again mainly for use by MBL software. A connect with any other
  153. parameter connects to the Node, then passes the command to the Node's command
  154. processor, thus allowing you to enter a normal Connect from either TNC or NODE
  155. command level.
  156.  
  157. CONV
  158. TRANS 
  159. UNPROTO CALL [VIA CALL ...]
  160. BTEXT
  161.  
  162. The CONV and TRANS command enter the appropriate state, and if not connected
  163. to the Node, allow you to send UI frames. This is used for the MBL 'Mail for
  164. xxxx' broadcasts, and can be used for CQ's , etc. Beaconing is not supported,
  165. but the BTEXT text is saved, and may be send instead of the predefined ID
  166. message at intervals. This is primarily for RLI 'MAIL' beacons.
  167.  
  168.  
  169. Note that K is an abbreviation for NODE, not CONV, as in a normal TNC, as 
  170. normally you want to switch easily between TNC command and Node command modes.
  171.  
  172. SENDPAC
  173. CPACTIME    
  174. CR        - As normal TNC.
  175.  
  176.  
  177.                             John Wiseman, G8BPQ
  178.                             8/6/89
  179.  
  180.  
  181.